home *** CD-ROM | disk | FTP | other *** search
/ QRZ! Ham Radio 6 / QRZ Ham Radio Callsign Database - Volume 6.iso / pc / files / dsp / 56100tar.z / 56100tar / 56100 / g722 / 56116ads / ads16cmd.hlp next >
Encoding:
Text File  |  1992-04-15  |  22.4 KB  |  689 lines
  1. >commands
  2. +{    --------- DSP56116 APPLICATION DEVELOPMENT SYSTEM COMMANDS---------}
  3.  
  4. +  {A}SM [{DVx}] [(beginning at) addr] [{I}(nteractive)] [assembler_mnemonic]
  5. +  {B}REAK [{DV0..7}] [{#}bn] [{addr}|{OFF}] [{access}] [{type}] [{expression}]
  6. +  {C}HANGE [{DV0..7}] [reg[_block]/addr[_block] (to)[expression]
  7. +  {CO}PY (from) [{DVx}] addr[_block] (to)[{DV0..7}] addr
  8. +  {D}ISPLAY [{DV0..7}] [{ON}/{OFF}/{ALL}/{IO}] [reg[_block/_group]/addr[_block]]...
  9. +  {D}ISPLAY {W}(active DVs)/{V}(version)
  10. +  {DE}VICE {DV0..7} [{ON}/{OFF}]
  11. +  {DI}SASSEMBLE [{DV0..7}] [addr[_block]]
  12. +  {E}VALUATE [{DVx}] [{B}(binary)/{D}(decimal)/{F}(float)/{H}(hexadecimal)] expression
  13. +  {F}ORCE [{DV0..7}] {a|b|c|d|e}
  14. +  {G}O [{DV0..7}] [(from)addr/{R}(reset)] [(to break #){#}bn] [(occurrence){:}count]
  15. +  {H}ELP [{DVx}] [command|register|{vectors}|{io}]
  16. +  {HO}ST (address)[{IO}] [{TIMEOUT}] [{hex value for IO address or TIMEOUT count}]
  17. +  {I}NPUT [{DV0..7}] [{#}number] {OFF}/{TERM}/filename [{-rd}|{-rf}|{-rh}]
  18. +  {L}OAD [{DV0..7}|{S}(state)}] (from) filename
  19. +  {LO}G [{DV0..7}] [{OFF}] [{C}(commands)/{S}(session) [filename]]
  20. +  {O}UTPUT [{DV0..7}] [{#}number] {OFF}/{TERM}/filename [{-rd}|{-rf}|{-rh}]
  21. +  {P}ATH [{DV0..7}] [pathname]
  22. +  {Q}UIT
  23. +  {R}ADIX [{DV0..7}] [{B}(bin)/{D}(dec)/{H}(hex)/{F}(float)] [reg[_block]/addr[_block]
  24. <  {S}AVE [{DV0..7}] {S}(state)/addr_block... filename
  25. +  {ST}EP [{DV0..7}] [count]
  26. +  {SY}STEM [system_command [parameter_list]]
  27. +  {T}RACE [{DV0..7}] [count]
  28. +  {W}AIT [count(seconds)]
  29. +  {Macro filename}
  30. +  {;}comment string entry
  31. +{----------- Other Help Topics ----------------}
  32. +  {io}  : list of on-chip io registers and their addresses
  33. +  {int} : list of interrupt vector addresses
  34. +  {pin} : list of pin names and numbers
  35. >tio
  36. +
  37. +{----------- Terminal Input Examples ----------}
  38. +
  39. +  Input data value may be hexadecimal, decimal, float, or pin data.
  40. +  Hex input just expects hex digits 0-f.  Don't precede with $.
  41. +  Decimal input expects decimal integers. Don't use float notation.
  42. +  Float input accepts almost any floating point format.
  43. +  Pin data input expects 1, 0, or x for each pin.  No imbedded blanks.
  44. +
  45. >assemble
  46. +
  47. +{----------- ASM: Single Line Assembler ----------}
  48. +
  49. +  {A}SM [{DV0..7}] [(beginning at) addr] [assembler_mnemonic]
  50. +
  51. +  {asm p:$50}
  52. +   Start interactive assembler at program address 50(hex) of default Device.
  53. +
  54. +  {asm x:0 move r0,d0.l}
  55. +  Assemble single instruction at x memory address 0 of default Device.
  56. +
  57. +  {asm}
  58. +  Start assembler at current program counter value of default Device.
  59. +
  60. +  {asm dv3 p:100}
  61. +  Start assembler at program memory address 100 (decimal) of Device 3.
  62. +
  63. +  {asm i}
  64. +  Start assembler at current program counter value of default Device.
  65. +  After instruction is assembled and placed in memory, trace the instruction.
  66. +
  67. +  {asm p:$50 i move #1,x0}
  68. +  Assemble a move #1,x0 instruction, place the opcode at program address
  69. +  50 hex, and immediately execute the instruction.
  70. +
  71. >break
  72. +
  73. +{----------- BREAK: Set, Modify, or Clear Breakpoint -----------}
  74. +
  75. +  {B}REAK [{DV0..7}] [{#}bn] [{addr}|{OFF}] [{access}] [{type}]
  76.        {address|address_range} [{count}] [{expression}]
  77. +
  78. +  There are two types of breakpoints that may be programmed.  These are
  79. +  software breakpoints and hardware breakpoints.  There are 15 software
  80. +  conditional breakpoints which monitor condition code register bits
  81. +  and 21 conditional floating point breakpoints which monitor condition
  82. +  code register, IEEE exception register and Exception register bits.
  83. +  A total of 99 software breakpoints may be set at one time in user
  84. +  program RAM and must be set at opcode addresses and not operand addresses.
  85. +
  86. +  There are 8 types of hardware breakpoints where 4 types pertain to
  87. +  program memory accesses and 4 pertain to data memory accesses. Program
  88. +  and data memory breakpoints may be set simultaneously.  One program and
  89. +  one data memory hardware breakpoint is allowed.
  90. <
  91. +  There are certain default rules for setting breakpoints with a minimun
  92. +  of key strokes as follows:
  93. +  1. Default breakpoints are always software if no type is entered and
  94. +     a single address is specified.
  95. +  2. If a breakpoint range is specified and no type is entered it will
  96. +     default to a hardware breakpoint of a read of program core fetch.
  97. +  3. If more than one range is entered in a breakpoint list, the last range
  98. +     will be the hardware breakpoint.
  99. +  4. Default breakpoint count is 1 unless specified.  Software breakpoints
  100. +     are always count of 1.
  101. <
  102. +
  103. +    Hardware Breakpoint Types            Software Breakpoint Types
  104. +  {pcf}   program core fetch         {cc}  carry clear  (c=0)
  105. +  {pcm}   program core move         {cs}  carry set    (c=1)
  106. +                     {eq}  equal        (z=1)
  107. +  {xab1}  X Address Bus 1 access     {ge}  greater or equal (n && v = 0)
  108. +  {xab2}  X Address Bus 2 access     {gt}  greater than (z v (n && v) = 0)
  109. +                     {hi}  higher        (z v c = 0)
  110. +                     {le}  less or equal (z v (n && v) = 1)
  111. +                     {ls}  lower or same (z v c = 1)
  112. +                     {lt}  less than    (n && v = 1)
  113. +  Hardware Breakpoint Accesses      {mi}  minus        (n = 1)
  114. +  {r}       break on read only         {ne}  not equal    (z = 0)
  115. +  {w}       break on write only         {pl}  plus        (n = 0)
  116. +  {rw}    break on read or write     {vc}  overflow clear (v = 0)
  117. +                     {vs}  overflow set (v = 1)
  118. +                     {al}  always true  (n.a.)
  119. +
  120. <
  121. +  A breakpoint expression may be any logical expression that is valid for
  122. +  the DSP56116 Macro Assembler (ASM56116).  The following is a list of
  123. +  operators that may be used in the breakpoint expression:
  124. +
  125. +    {<}   less than             {&&}   logical 'and'
  126. +    {<=}  less than or equal to     {||}   logical 'or'
  127. +    {==}  equal to             {! }   logical 'negate'
  128. +    {>=}  greater than or equal to  {& }   bitwise 'and'
  129. +    {> }  greater than          {| }   bitwise 'or'
  130. +    {!=}  not equal to          {~ }   bitwise one's complement
  131. +    {+ }  addition             {^ }   bitwise 'exclusive or'
  132. +    {- }  subtraction             {<<}   shift left
  133. +    {/ }  division             {>>}   shift right
  134. +
  135. <
  136. +  {----------- Breakpoint Actions -----------}
  137. +    {H }    Halt execution.  This is the default.
  138. +    {In}    Increment counter variable CNTn (n=1/2/3/4).
  139. +    {N }    Note - display the breakpoint expression and continue.
  140. +    {S }    Show the enabled register/memory set and continue.
  141. +
  142. +  {----------- Examples -----------}
  143. +  {break}
  144. +  Display all currently enabled breakpoints.
  145. +
  146. +  {break off}
  147. +  Remove all currently enabled breakpoints.
  148. +
  149. +  {break #1 off}
  150. +  Remove breakpoint number 1.
  151. +
  152. <  {break $500 }
  153. +   The default Device halts program execution when the program counter reaches
  154. +   the instruction at address 500.
  155. +
  156. +   {break p:300 t(lc<10)&&(r0>100)}
  157. +  The default Device will test the conditions of the expression when the
  158. +  program counter reaches the instruction at address 300.  If the condition
  159. +  is true the Device will halt program execution and display its registers.
  160. +
  161. +  {break dv2 p:1000}
  162. +  Device 2 will halt program execution and display its registers when its
  163. +  program counter reaches the instruction at address 1000.
  164. +
  165. +  {break al p:105}
  166. +  Set a software breakpoint at program address 105.  The software breakpoint
  167. +  will be a debug opcode and it should be placed at an opcode address always.
  168. +
  169. >change
  170. +
  171. +  {----------- CHANGE: Change Register or Memory Value -----------
  172. +
  173. + {C}HANGE [{DV0..7}] [reg[_block]/addr[_block] (to)[expression]
  174. +
  175. +  {change pc}
  176. +  Display register values individually starting with the program counter
  177. +  and prompt the user for new values.
  178. +
  179. +  {change dv2 x:$55}
  180. +  Display Device 2 X memory location 55(hex) and prompt the user for a new value.
  181. +
  182. +  {change p:$20 $123456 }
  183. +  Change p memory address hexadecimal 20 to hexadecimal 123456.
  184. +
  185. +  {change r0..r7 0 p:$30..$300 0 x:$fffe $55 pc 100}
  186. +  Change the default Device registers r0 through r7 to 0, p memory addresses hexadecimal 30
  187. +  through 300 to 0, x memory address hex fffe to hex 55 and the program
  188. +  counter to 100 decimal.
  189. +
  190. +  {change dv3,4,7 p:$20 $123456 }
  191. +  Change Devices 3,4, and 7 p memory address 20(hex) to 123456(hex).
  192. +
  193. +  {change r0..r7 0 p:$30..$300 0 x:$fffe $55 pc 100}
  194. +  Change the default Device registers r0 through r7 to 0, p memory addresses
  195. +  hexadecimal 30 through 300 to 0, x memory address hex fffe to hex 55 and
  196. +  the program counter to 100 decimal.
  197. +
  198. >copy
  199. +
  200. +  {----------- COPY: Copy a Memory Block -----------}
  201. +
  202. +  {CO}PY (from) [{DVx}] addr[_block] (to)[{DV0..7}] addr
  203. +
  204. +  {copy p:$100..$500 x:$500}
  205. +  Copy the default Device program memory values located from 100(hex)
  206. +  through hexadecimal 500 to x memory starting at hexadecimal 500.
  207. +
  208. +  {copy x:0#100 p:0}
  209. +  Copy one hundred memory locations of the default Device beginning at X
  210. +  memory location 0 to p memory beginning at location 0.
  211. +
  212. +  {copy p:0..20 p:40}
  213. +  Copy p memory locations 0 through 20 to p memory locations 40 through 60.
  214. +
  215. +  {copy dv1 p:0..20 d2..5 p:40}
  216. +  Copy Device 1 p memory locations 0 through 20 to Devices 2,3,4 and 5 p memory
  217. +  locations 40 through 60.
  218. >disassemble
  219. +
  220. +  {----------- DISASSEMBLE: Object Code Disassembler -----------}
  221. +
  222. +  {DI}SASSEMBLE [addr[_block]]
  223. +
  224. +  {disassemble }
  225. +  Disassemble 20 instructions beginning at program counter address.
  226. +
  227. +  {disassemble y:5}
  228. +  Disassemble 20 instructions beginning at y memory map address 5.
  229. +
  230. +  {disassemble p:0..20}
  231. +  Disassemble program memory address block 0 to 20.
  232. +
  233. +  {disassemble x:$50#10}
  234. +  Disassemble 10 instructions starting at x memory map hex 50.
  235. +
  236. >display
  237. +
  238. +  {-----------DISPLAY: Display Register or Memory -----------}
  239. +
  240. + {D}ISPLAY [{DV0..7}] [{ON}/{OFF}/{ALL}/{IO}] [reg[_block/_group]/addr[_block]].
  241. +  {D}ISPLAY {W}(active DVs)/{V}(version)
  242. +
  243. +  {display}
  244. +  Display all currently enabled registers and memory.
  245. +
  246. +  {display w}
  247. +  Display Devices that are currently executing user programs.
  248. +
  249. +  {display v}
  250. +  Display ADS56116 rev. number, date of release, and default Device monitor rev.
  251. +
  252. +  {display dv2 v}
  253. +  Display ADS56116 rev. number, data of release, and Device #2 monitor rev.
  254. +
  255. +  {----------- Register and Memory Display Modes -----------}
  256. +
  257. +    {ON}  Always display the following registers and memory locations.
  258. +    {OFF} Never display the following registers and memory locations.
  259. +
  260. +  {----------- Examples -----------}
  261. +
  262. +  {display on }
  263. +  Enable all registers and stacked levels for display
  264. +
  265. +  {display on p:0..20 x:30..40 y:$100}
  266. +  Display enable p memory address block 0 to 20, x memory address block
  267. +  30 to 40 and y memory address hexadecimal 100.
  268. +
  269. +  {display off }
  270. +  {display on dsp}
  271. +  Disable all display, then enable display of the DSP56116 programming model
  272. +  registers only.
  273. +
  274. <
  275. +  {----------- Register Group Names -----------}
  276. +
  277. +    {ALL}   all registers.
  278. +    {DSP}   all of the DSP56116 programming model registers.
  279. +    {IO}    all peripheral registers.
  280. +    {SSI0}  all synchronous serial interface 0 registers.
  281. +    {SSI1}  all synchronous serial interface 1 registers.
  282. +    {ONCE}  all on-chip emulator registers.
  283. +    {HOST}  all host port interface registers.
  284. +    {STACK} all current stacked levels.
  285. +
  286. +  {display stack}
  287. +  Immediate display of all stacked levels up to the current stack pointer
  288. +  value.  Example: sp=5 shows stacked values from 1 to 5.
  289. +
  290. >device
  291. +
  292. +  {----------- DEVICE: Select a Default Device --------------}
  293. +
  294. + {DE}VICE {DV0..7} [{ON}/{OFF}]
  295. +
  296. +  {device}
  297. +  Display the current active Device(s) and default Device to be addressed.
  298. +
  299. +  {device dv2}
  300. +  Select Device number 2 as the default Device for command entry.
  301. +
  302. +  {device dv0..2 on}
  303. +  Enable Devices 0,1,and 2 as active devices.
  304. +
  305. >evaluate
  306. +
  307. +  {----------- EVALUATE: Evaluate an Expression -----------}
  308. +
  309. + {E}VALUATE [{DVx}] [{B}(binary)/{D}(decimal)/{F}(float)/{H}(hexadecimal)] expression
  310. +
  311. +  Following is a list of valid operators useable in an expression:
  312. +    {<}   less than             {&&}   logical 'and'
  313. +    {<=}  less than or equal to     {||}   logical 'or'
  314. +    {==}  equal to             {! }   logical 'negate'
  315. +    {>=}  greater than or equal to  {& }   bitwise 'and'
  316. +    {> }  greater than          {| }   bitwise 'or'
  317. +    {!=}  not equal to          {~ }   bitwise one's complement
  318. +    {+ }  addition             {^ }   bitwise 'exclusive or'
  319. +    {- }  subtraction             {<<}   shift left
  320. +    {/ }  division             {>>}   shift right
  321. +
  322. +  {evaluate r0+p:$50}
  323. +  Add the value in r0 register to the value in program memory address
  324. +  hexadecimal 50 and display the result using the default radix.
  325. +
  326. +  {evaluate b $345 }
  327. +  Convert hexadecimal 345 to binary and display the result.
  328. +
  329. +  {evaluate h %10101010&p:r0 }
  330. +  Calculate the bitwise AND of the program memory address specified by the
  331. +  value in r0 register and the binary value 10101010 and display the result
  332. +  in hexadecimal.
  333. +
  334. >force
  335. +
  336. +  {----------- FORCE: Assert Reset or Break on a Device -----------}
  337. +
  338. +  {F}ORCE [{DV0..7}] {a|b|c|d|e}
  339. +  The a and b options are for the command convertor while the c,d and e
  340. +  options are for the target 56116.
  341. +
  342. +  {force a}
  343. +  Force a reset on the current default command convertor.}
  344. +
  345. +  {force b}
  346. +  Force an interrupt on the current default command convertor.
  347. +
  348. +  {force c}
  349. +  Force a reset on the current default target 56116.  This will reset
  350. +  the target 56116 into the operating mode specified by the MODA and MODB
  351. +  pins.
  352. +
  353. +  {force d}
  354. +  Force the current default target 56116 into OnCE mode.
  355. +
  356. +  {force e}
  357. +  Force a reset on the current default target 56116 with the debug request
  358. +  pin asserted.  This will reset the target 56116 into OnCE debug mode.
  359. +
  360. +  {force dv1,4,5 b}
  361. +  Force an interrupt on command convertors 1,4 and 5.
  362. +
  363. + Note: Execution of a force command from a macro file should be followed by
  364. + a {wait 1} command to allow the Device reset capacitor time constant to charge
  365. +
  366. >go
  367. +
  368. +  {----------- GO: Execute DSP56116 Program -----------}
  369. +
  370. + {G}O [{DV0..7}] [(from)addr/{R}(reset)] [(to break #){#}bn] [(occurrence){:}count]
  371. +
  372. + {go}
  373. +  Start DSP56116 program execution from the current program counter value
  374. +  of the default Device.
  375. +
  376. +  {go $100}
  377. +  Load the default Device program counter with hexidecimal 100 and start
  378. +  DSP56116 program execution.
  379. +
  380. +  {go dv1..3}
  381. +  Start DSP56116 program execution of Devices 1,2 and 3 at their current
  382. +  program counter addresses.
  383. +
  384. +  {go dv1 100 #5 :3}
  385. +  Start DSP56116 program execution of Device 1 from address P:100.  Halt on
  386. +  the third occurrence of breakpoint number 5.
  387. +
  388. >help
  389. +
  390. +  {----------- HELP: ADS56116 User Interface Help Text -----------
  391. +
  392. + {H}ELP [{DVx}] [command|register|topic]
  393. +
  394. +  {help}
  395. +  Display a summary of all available commands and their parameters.
  396. +
  397. +  {help asm}
  398. +  Display a summary of the assemble command and its parameters.
  399. +
  400. +  {help dv1 host}
  401. +  Define host register bits and display the current value of Device# 1.
  402. +
  403. +  {help vectors}
  404. +  Display the vector addresses and the vector source}
  405. +
  406. +  {help io}
  407. +  Display the X Memory Internal I/O Map}
  408. +
  409. >host
  410. +  {----------- HOST: Change HOST Interface Address -----------}
  411. +
  412. + {HO}ST (address)[{IO}|{TIMEOUT}] [{value}]
  413. +
  414. +  {host}
  415. +  Display the current HOST Interface Card address.
  416. +
  417. +  {host io $200}
  418. +  Change the host Interface address offset to hexidecimal 200.
  419. +  This command arguement is only valid for the IBM-PC host.
  420. +
  421. +  {host timeout $1ffff}
  422. +  Change the host timeout for software handshakes to the ADM board
  423. +  to a value of hex 1ffff.  The timeout argument is used on PCs that
  424. +  run at faster clock speeds and is used to eliminate timeout errors.
  425. +
  426. >input
  427. +
  428. +  {----------- INPUT: Assign Input File -----------}
  429. +
  430. + {I}NPUT [{DV0..7}] [{#}number] {OFF}/{TERM}/filename [{-rd}|{-rf}|{-rh}]
  431. +
  432. +  {input}
  433. +  Display currently open input files for default Device.
  434. +
  435.   {input dv1 #4 data}
  436. +  Open 'data.io' file number 4 for input to Device 2.
  437. +
  438. +  {input dv2 #1 off}
  439. +  Close current input data file number 1 assigned to Device 2.
  440. +
  441. +  {input data -rf}
  442. +  Open 'data.io' file for floating point input values and assign
  443. +  a file number to it.
  444. +  Note: -rd = radix decimal, -rf = radix float, -rh = radix hexadecimal
  445. +
  446. >load
  447. +
  448. +  {----------- LOAD: Load DSP56116 Files -----------}
  449. +
  450. + {L}OAD [{DV0..7}|{S}(state)}] (from) filename
  451. +
  452. ; PC
  453. ;  {load \\source\\testloop.obj}
  454. ; MAC
  455. ;  {load hd:source:testloop.obj}
  456. ; OTHER
  457. +  {load /source/testloop.obj}
  458. +  Load 'testloop.obj' file from directory 'source'.
  459. +
  460. +  {load lasttest}
  461. +  Load 'lasttest.lod' file from current directory.
  462. +
  463. +  {load s lunchbrk}
  464. +  Load 'lunchbrk.ads', replacing the entire current ads56116 state.
  465. +
  466. +  {load dv0..2 testdata}
  467. +  Load Device 0,1 and 2 with the contents of 'testdata.lod' file.
  468. +
  469. >log
  470. +
  471. +  {----------- LOG: Log Commands and/or Session -----------
  472. +
  473. + {LO}G [{DV0..7}] [{OFF}] [{C}(commands)/{S}(session) [filename]]
  474. +
  475. +  {log }
  476. +  Display currently opened log files of default Device.
  477. +
  478. ; PC
  479. ;  {log s \\debugger\\session1}
  480. ; MAC
  481. ;  {log s hd:debugger:session1}
  482. ; OTHER
  483. +  {log s /debugger/session1}
  484. +  Log all default Device display entries to filename 'session1.log' in
  485. +  directory 'debugger'
  486. +
  487. +  {log c macro1}
  488. +  Log all commands for default Device to filename 'macro1.cmd'.
  489. +
  490. +  {log off c}
  491. +  Terminate command logging for default Device.
  492. +
  493. +  {log off}
  494. +  Terminate all logging for default Device.
  495. +
  496. +  {log dv0..7 s logfile}
  497. +  Log all Device display entries to filename 'logfile.log'
  498. +
  499. >output
  500. +
  501. +  {----------- OUTPUT: Assign Output File -----------}
  502. +
  503. + {O}UTPUT [{DV0..7}] [{#}number] {OFF}/{TERM}/filename [{-rd}|{-rf}|{-rh}]
  504. +
  505. +  {output}
  506. +  Display all output files currently open for default Device.
  507. +
  508. +  {output #1 term}
  509. +  Open output file number 1 to the terminal.  All outputs will be displayed
  510. +  on the screen.
  511. +
  512. +  {output dv2 #5 admout}
  513. +  Open output file number 5 called 'admout.io' for Device 2.
  514. +
  515. +  {output dv2 #1 off}
  516. +  Close output file number 1 for Device 2.
  517. +
  518. +  {output data -rf}
  519. +  Open 'data.io' file for floating point output values and assign
  520. +  a file number to it.
  521. +  Note: -rd = radix decimal, -rf = radix float, -rh = radix hexadecimal
  522. +
  523. +  {WORD TRANSFERS}
  524. +  User program must {jsr $E004} with file number in X0 register
  525. +  and the word to transfer in the A1 register.
  526. +  On return: The Extension(E) bit in the status register will be set if an
  527. +  incorrect transfer occurs, otherwise the E bit will be zero.
  528. +
  529. +  {BLOCK TRANSFERS}
  530. +  User program must {jsr $E006} with file number in upper byte of X0 register
  531. +  the block size in the lower two bytes of X0 and the starting memory
  532. +  location to transfer data block to in R7.
  533. +  On return: The (E) bit in the status register will be set if an
  534. +  incorrect transfer occurs, otherwise the E bit will be zero.
  535. +
  536. >path
  537. +
  538. +  {----------- PATH: Specify Default Pathname -----------}
  539. +
  540. + {P}ATH [{DV0..7}] [pathname]
  541. +
  542. ; PC
  543. ;  {path \\adm}
  544. ;  Define the default directory for ADS files as '\\adm'.
  545. ;
  546. ;  {path \\adm\\day2}
  547. ;  Define the default directory for ADS files as '\\adm\\day2'.
  548. ; MAC
  549. ;  {path hd:adm}
  550. ;  Define the default directory for ADS files as 'hd:adm'.
  551. ;
  552. ;  {path hd:adm:day2}
  553. ;  Define the default directory for ADS files as 'hd:adm:day2'.
  554. +  {path /adm/day2}
  555. +  Define the default directory for ADS files as '/adm/day2'.
  556. +
  557. +  {path}
  558. +  Show the current default pathname.
  559. +
  560. >quit
  561. +
  562. +  {----------- QUIT: Quit DSP56116 User Interface Session -----------}
  563. +
  564. +  {Q}UIT
  565. +
  566. >radix
  567. +
  568. +  {----------- RADIX: Change Input or Display Radix --------}
  569. +
  570. + {R}ADIX [{DV0..7}] [{B}(bin)/{D}(dec)/{H}(hex)/{F}(float)] [reg[_block]/addr[_block]
  571. +
  572. +  {radix}
  573. +  Display the default radix currently enabled.
  574. +
  575. +  {radix h}
  576. +  Change input radix to hexadecimal.  Hexadecimal constant entries
  577. +  no longer require a preceding dollar sign, but any decimal constants will
  578. +  require a preceding grave accent ({`}).
  579. +
  580. +  {radix dv1 f x:$100..$1ff}
  581. +  Enable floating point radix display of X memory 100 hex to 1ff hex for
  582. +  Device #1
  583. +
  584. +  {radix d a2 a1 a0}
  585. +  Enable decimal radix display for registers a2,a1 and a0 of default Device.
  586. +
  587. >save
  588. +
  589. +  {----------- SAVE: Save ADS56116 File -----------}
  590. +
  591. + {S}AVE [{DV0..7}] {S}(state)/addr_block... filename
  592. +
  593. +  {save p:0..$ff x:0..$20 y:0..$20 session1}
  594. +  Save all three memory maps to OMF file 'session1.lod'.
  595. +
  596. +  {save s lunchbrk}
  597. +  Save the default Device state to filename 'lunchbrk.adm'.
  598. +
  599. +  {save dv1..3 s lunchbrk.b}
  600. +  Save the state of Devices 1,2 and 3 to filename 'lunchbrk.b'.
  601. +  Note: Device#1 path will be the path name preceded to the filename.
  602. +
  603. >step
  604. +
  605. +  {----------- STEP: Step Through DSP56116 Program -----------}
  606. +
  607. + {ST}EP [{DV0..7}] [count]
  608. +
  609. +  {step }
  610. +  Step one instruction and display the enabled registers and memory blocks.
  611. +
  612. +  {step $50}
  613. +  Execute hex 50 instructions and display the enabled registers and memory
  614. +  blocks at the end of the hex 50th instruction.
  615. +
  616. +  {step dv1..4 10}
  617. +  Execute 10 instructions on Devices 1,2,3 and 4 siumultaneously and
  618. +  display the enabled registers and memory blocks of each when they have
  619. +  each completed their 10 instructions.
  620. +
  621. >system
  622. +
  623. +  {----------- SYSTEM: Execute System Command -----------}
  624. +
  625. +  {SY}STEM [system_command [parameter_list]]
  626. +
  627. +  {system dir}
  628. +  Execute the system 'dir' command and immediately return to the ADS56116.
  629. +
  630. +  {system dir *.io}
  631. +  Execute the system 'dir *.io' command
  632. +
  633. +  {system }
  634. +  {dir *.io}
  635. +  {del he.io}
  636. +  {exit}
  637. +  Leave the ADS program  temporarily.    Execute the system 'dir *.io' and
  638. +  'del he.io' commands.  Return to the ADS program when the system 'exit'
  639. +  command is executed.
  640. +
  641. >trace
  642. +
  643. +  {----------- TRACE: Trace Through DSP56116 Program -----------}
  644. +
  645. + {T}RACE [{DV0..7}] [count]
  646. +
  647. +  {trace }
  648. +  Execute one instruction and display the enabled registers and memory
  649. +  blocks.
  650. +
  651. +  {trace 20}
  652. +  Execute 20 instructions and display the enabled registers and memory
  653. +  blocks after each instruction.
  654. +
  655. +  {trace dv2,4 5}
  656. +  Execute 5 instructions on Devices 2 and 4 from their current program counter
  657. +  and display their enabled registers and memory blocks after each instruction.+
  658. >wait
  659. +
  660. +  {----------- WAIT: Wait Specified Time -----------}
  661. +
  662. +  {W}AIT [count(seconds)]
  663. +
  664. +  The wait command pauses for count seconds or until the user types any key
  665. +  before continuing to the next command.  If the wait command is entered
  666. +  without a count parameter,  the command will only terminate if the user
  667. +  types a key.  This command is useful when using a macro file to execute
  668. +  a group of instructions and pause for a review of displayed results.
  669. +
  670. >comments
  671. +
  672. +  {----------- User Comments -----------}
  673. +
  674. +  {;}comment string entry
  675. +
  676. +  Anything on the command line following a semicolon is considered a user
  677. +  comment.  It can be logged to the output log files to document a session.
  678. +
  679. >macros
  680. +
  681. +  {----------- Macro Commands -----------}
  682. +
  683. +  {Macro filename}
  684. +
  685. +  Any unrecognized mnemonic entry will be interpreted as a macro name.
  686. +  Macro command files may be created using the ADS56116 LOG command.
  687. +
  688.  
  689.